Risk Signal: Department of Motor Vehicles Check

The Jumio Department of Motor Vehicles (DMV) check is used to validate that a US driver’s license or ID card issued by the DMV is valid.

Supported Credentials

The following values can be uploaded as Prepared Data. Alternatively, they can be extracted by an upstream capability in a workflow.

Key

Type

Mandatory

Description

firstName

string

Yes

 

middleName

string

No

 

lastName

string

Yes

 

dateOfBirth

string

Yes

in yyyy-MM-dd format

address fields

address.line1

address.line2

address.city

address.postalCode

address.subdivision

address.country

 

string

string

string

string

string


string

 

Yes

No

Yes

Yes

Yes

 

 

 

 

 

State name can be provided here.
See Supported States.

country should be ISO Alpha 3 Code only

id.idNumber

string

Yes

number for ID being provided 

id.issuingDate

string

No

in yyyy-MM-dd format only

id.expiryDate

string

No

in yyyy-MM-dd format only

id.type

string

Yes

only possible values are: 

  • DRIVING_LICENSE

  • PERMIT

  • ID_CARD

Example Prepared Data Body

{
    "firstName": "J****",
    "middleName": "J****",
    "lastName": "****h",
    "dateOfBirth": "1972-**-1*",
    "address": {
        "line1": "***** SW Address Ln",
        "postalCode": "9***1",
        "city": "****",
        "subdivision": "OR",
        "country": "USA"
    },
    "id": { 
        "idNumber": "0*****812", 
        "type": "DRIVING_LICENSE",
        "issuingDate": "20**-01-**",
        "expiryDate": "20**-01-**"
    }
}

Response

Response data is available for transactions that include the risk signal. For information on transaction data see Viewing or Retrieving Workflow Transactions.

Example Response

"drivingLicenseVerification": [
            {
                "id": "bd91fa85-8ef8-42d2-a064-954a30c10ed6",
                "credentials": [
                    {
                        "id": "51c426f0-3e34-4c62-a552-85a73e9d52de",
                        "category": "DATA"
                    }
                ],
                "decision": {
                    "type": "WARNING",
                    "details": {
                        "label": "ALERT"
                    }
                },
                "data": {
                    "nameMatch": "MATCH",
                    "firstNameMatch": "MATCH",
                    "lastNameMatch": "MATCH",
                    "middleNameMatch": "MATCH",
                    "addressMatch": "NOT_MATCH",
                    "addressLine1Match": "NOT_MATCH",
                    "addressLine2Match": "NOT_MATCH",
                    "cityMatch": "MATCH",
                    "stateMatch": "MATCH",
                    "zipCodeMatch": "MATCH",
                    "dobMatch": "MATCH",
                    "idNumberMatch": "MATCH",
                    "expiryDateMatch": "MATCH",
                    "issuingDateMatch": "MATCH"
                },
            }

Decision Details Labels

Decision Type

Label

Description

PASSED

OK

Provided data matches DMV data.

REJECTED

DENY

 Provided data does not match DMV data.

WARNING

ALERT

 Provided data partially matches DMV data.

NOT_EXECUTED

UNSUPPORTED_COUNTRY

Provided address.country value is not supported. Must be USA.

NOT_EXECUTED

UNSUPPORTED_STATE

 Provided address.subdivision value is not supported. Must be a USA state listed below.

NOT_EXECUTED

TECHNICAL_ERROR

Verify the provided data is correct and retry, or contact Support.

Data

Key

Possible Values

Description

nameMatch

MATCH

NOT_MATCH

First and last name both match.

firstNameMatch

MATCH

NOT_MATCH

First name matches.

lastNameMatch

MATCH

NOT_MATCH

Last name matches.

middleNameMatch

MATCH

NOT_MATCH

Middle name matches.

addressMatch

MATCH

NOT_MATCH

 All address values match.

addressLine1Match

MATCH

NOT_MATCH

 Line1 address value matches.

addressLine2Match

MATCH

NOT_MATCH

 Line2 address value matches.

cityMatch

MATCH

NOT_MATCH

 City address value matches.

stateMatch

MATCH

NOT_MATCH

 State address value matches.

zipCodeMatch

MATCH

NOT_MATCH

 Postal code address value matches.

dobMatch

MATCH

NOT_MATCH

 Date of birth matches.

idNumberMatch

MATCH

NOT_MATCH

 The number of the license, permit, or ID card matches.

expiryDateMatch

MATCH

NOT_MATCH

Expiration date matches.

issuingDateMatch

MATCH

NOT_MATCH

Issue date matches.

Supported States

The following states are supported by our DMV check today. Currently, this is available in the USA only.

State Abbrv Code
ALABAMA AL
ARKANSAS AR
ARIZONA AZ
COLORADO CO
CONNECTICUT CT
DISTRICT OF COLUMBIA DC
DELAWARE DE
FLORIDA FL
GEORGIA GA
HAWAII HI
IOWA IA
IDAHO ID
ILLINOIS IL
INDIANA IN
KANSAS KS
KENTUCKY KY
MASSACHUSETTS MA
MARYLAND MD
MAINE ME
MICHIGAN MI
MISSOURI MO
MISSISSIPPI MS
MONTANA MT
NORTH CAROLINA NC
NORTH DAKOTA ND
NEBRASKA NE
NEW JERSEY NJ
NEW MEXICO NM
NEVADA NV
OHIO OH
OREGON OR
RHODE ISLAND RI
SOUTH DAKOTA SD
TENNESSEE TN
TEXAS TX
VIRGINIA VA
VERMONT VT
WASHINGTON WA
WISCONSIN WI
WEST VIRGINIA WV
WYOMING WY